Aller au contenu principal

Sélection d’un indicateur

Le Carrefour de données permet aux économistes et aux chercheurs d’accéder à un large éventail de valeurs d'indicateurs du marché du travail au Canada. La sélection d’un indicateur à interroger fait partie des premières étapes de l’utilisation du Carrefour de données. Un seul indicateur peut être sélectionné par requête, et les données peuvent provenir de plusieurs sources. Il est important de garder à l'esprit que les indicateurs ne peuvent pas tous être interrogés de la même façon. Cette section présente les notions de base de la sélection d’un indicateur pour une requête API.

Point de terminaison et chaînes de requête​

Comme toujours, le seul point de terminaison de l’API est :

https://lmic-datahub-prod-gw-d6ow9n6v.uc.gateway.dev/lmi

Chaque requête doit contenir le paramètre de requête « indicator » avec une valeur de 1–18. Ces valeurs font référence aux indicateurs fournis par l’API. Lorsque vous ajoutez l’indicateur au point de terminaison, ajoutez un «?» afin que l’API sache où se termine l’URL et où commence la chaîne de requête.

Exemples​

Les exemples suivants sont des requêtes API simples qui spécifient un indicateur. Les dates sont arbitraires, car aucune période n’est précisée, et le niveau d’agrégation géographique est la valeur par défaut : Canada.

Niveau de chômage​

Requête :

curl --location --request POST 'https://lmic-datahub-prod-gw-d6ow9n6v.uc.gateway.dev/lmi?indicator=5' \
--header 'x-api-key: API_KEY' \
--data-raw ''

Réponse :

{
    "data": [
        {
            "source": "LFS-14100287; LFS-14100017",
            "as_of_date": "2022-03-01",
            "ref_date": "2022-03-01",
            "data_frequency": "monthly",
            "country": "Canada",
            "provinces_territories": null,
            "cma_en": null,
            "economic_regions_en": null,
            "sex_en": "Both sexes",
            "age_en": "15 years and over",
            "noc_level": null,
            "noc_code": null,
            "noc_title_en": null,
            "naics_level": null,
            "naics_code": null,
            "naics_title_en": null,
            "adjustment_en": "unadjusted",
            "indicator_name_en": "Unemployment level",
            "indicator_value": 1171700.0
        }
    ],
    "meta": {
        "current_page": 1,
        "total_pages": 1,
        "per_page": 1000,
        "total_rows": 1
    }
}

Niveau de population​

Request:

curl --location --request POST 'https://lmic-datahub-prod-gw-d6ow9n6v.uc.gateway.dev/lmi?indicator=9' \
--header 'x-api-key: API_KEY' \
--data-raw ''

Response:

    {
        "data": [
            {
                "source": "LFS-14100017; LFS-14100287",
                "as_of_date": "2022-03-01",
                "ref_date": "2022-03-01",
                "data_frequency": "monthly",
                "country": "Canada",
                "provinces_territories": null,
                "cma_en": null,
                "economic_regions_en": null,
                "sex_en": "Both sexes",
                "age_en": "15 years and over",
                "noc_level": null,
                "noc_code": null,
                "noc_title_en": null,
                "naics_level": null,
                "naics_code": null,
                "naics_title_en": null,
                "adjustment_en": "unadjusted",
                "indicator_name_en": "Population level",
                "indicator_value": 31626900.0
            }
        ],
        "meta": {
            "current_page": 1,
            "total_pages": 1,
            "per_page": 1000,
            "total_rows": 1
        }
    }

Salaires hebdomadaires moyens​

Requête :

curl --location --request POST 'https://lmic-datahub-prod-gw-d6ow9n6v.uc.gateway.dev/lmi?indicator=11' \
--header 'x-api-key: API_KEY' \
--data-raw ''

Réponse :

{
    "data": [
        {
            "source": "LFS-14100065",
            "as_of_date": "2022-03-01",
            "ref_date": "2022-03-01",
            "data_frequency": "monthly",
            "country": "Canada",
            "provinces_territories": null,
            "cma_en": null,
            "economic_regions_en": null,
            "sex_en": "Both sexes",
            "age_en": "15 years and over",
            "noc_level": null,
            "noc_code": null,
            "noc_title_en": null,
            "naics_level": null,
            "naics_code": null,
            "naics_title_en": null,
            "adjustment_en": "unadjusted",
            "indicator_name_en": "Mean weekly wages",
            "indicator_value": 1128.93
        }
    ],
    "meta": {
        "current_page": 1,
        "total_pages": 1,
        "per_page": 1000,
        "total_rows": 1
    }
}